Объект ПостроительОтчета предоставляет разработчику и пользователю отчета механизм условного оформления отчета. Данная статья описывает возможности механизма, показывает примеры использования.
Данный механизм предназначен для обеспечения необходимого оформления областей отчета с заданным условием. Механизм предоставляет следующие возможности:
Для применения условного оформления необходимо определить следующие его элементы:
Рассмотрим подробнее составляющие условного оформления.
Описание области, к которой применяется оформление, состоит из списка элементов областей. Каждый элемент области отчета состоит из имени поля отчета, и типа области: поле или группировка. В случае если данный список пуст, оформление применяется ко всей области данных отчета. Если область содержит как поля, так и группировки, то оформление будет применяться только к полям, которые принадлежат указанным группировкам. В случае если описание области содержит только элементы - поля, оформление будет применяться только к указанным полям. В случае если описание области содержит только группировки, оформление применяется ко всей области группировки, за исключением областей вложенных группировок и областей детальных записей. Для оформления области детальных записей, необходимо добавить в описание области группировку с пустым именем.
Для указания условия, при выполнении которого применяется оформление, используется объект Отбор. Данный объект содержит список полей с условиями, которые применяются к полям.
Описание оформление применятся для того, чтобы указать, как именно оформлять область отчета. Возможно указание следующих оформительских свойств:
Программный доступ к условному оформлению осуществляется через свойство построителя отчета УсловноеОформление. Данное свойство содержит описание условного оформления, которое применяется к отчету.
Для обеспечения редактирования условного оформления, построитель отчета предоставляет реквизит УсловноеОформление, который может быть связан с табличным полем. После связи данного реквизита с табличным полем, пользователю дается возможность самостоятельно добавлять/изменять/удалять элементы условного оформления, настраивать область, к которой применяется оформление, настраивать условие, при выполнении которого будет применяться оформление, описывать само оформление. Все эти операции реализуются автоматически, при помощи специализированных расширений табличных полей и полей ввода, никакого дополнительного программирования от разработчика отчета не требуется.
Пример использования условного оформления можно найти в демонстрационной конфигурации "Примеры ИТС", в отчете "ПродажиНоменклатуры". В данном отчете выводится отчет о продажах номенклатуры контрагентам. В отчете, при помощи условного оформления, зеленым фоном выделяются суммы, если их значения превышали 10000, желтым фоном выделяются строки номенклатуры, если объем продаж по данной номенклатуре превысил 30000, красным текстом в отчете выделяются строки, содержащие услуги.
Пример интерактивной настройки условного оформления можно посмотреть в том же отчете, в форме настройки отчета, на закладке "Оформление". При выполнении отчета данную форму можно вызвать, воспользовавшись кнопкой командной панели отчета "Настройка...".
На следующем рисунке показан пример того, как может выглядеть отчет и форма настройки условного оформления.
